Configuration Variables
Overview
In the CONNECT Edition, the software utilizes the native Power Platform configuration system to locate the dataset, connect to the project database, and specify various default settings.
New configuration variables have been introduced that can be set in any configuration file to configure the software. Below is a comprehensive list of the application specific variables that are used to configure the software and explain their purpose.
OpenUtilities Substation Configuration Variables
Application variables are prefixed with "ELEC_" to set them apart from the standard Power Platform variables.
The following table provides a complete list of the application specific variables and defines what if any dialog boxes within the software can set their values:
| Variable Name | Description | Dialogs that Control the Variable |
|---|---|---|
| ELEC_DRAWING_STANDARD | Drawing standard (IEC vs ANSI-IEEE) | Installer |
| ELEC_WORKSETSTANDARDS | Substation WorkSet standards folder | N/A |
| ELEC_WORKSETDGNS | Location where DGN files will be stored | N/A |
| ELEC_ENABLE_MANAGED_CONFIGURATION | (True/False variable that enables or disables the ProjectWise Managed Workspace integration) | New/Modify Project
WorkSpace Configuration Variables |
| ELEC_DEFAULT_PROJECT_DIR | (True/False variable that enables or disables the ProjectWise Managed Workspace integration) | New Project
WorkSpace Configuration Variables |
| ELEC_ACTIVEPARTSDATABASE | Active parts database name | New/Modify Project
WorkSpace Configuration Variables |
| ELEC_PARTS_DB_MAPPING_PATH | Path to the parts database mapping file which defines the connection to the parts database | WorkSpace Configuration Variables |
| ELEC_CATALOG_PATH | Promise loads all catalogs found in the specificed path as opposed to individual paths for each catalog. Users can specifiy multiple paths delimited by a semi-colon to load catalogs from multiple locations such as catalogs on a local machine vs a network location. | New/Modify Project
WorkSpace Configuration Variables |
| ELEC_LANGUAGE_DB_PATH | Path to the Multi-language.mdb file | N/A |
| ELEC_SYSTEM_OPTION_PROFILE | Path to the system option profile XML file | WorkSpace Configuration Variables |
| ELEC_PROJECT_OPTION_PROFILE | Path to the project option profile XML file | WorkSpace Configuration Variables |
| ELEC_USER_OPTION_PROFILE | Path to the user option profile XML file | WorkSpace Configuration Variables |
| ELEC_PRJ_PROFILE_DIR | Path to the project profiles | WorkSpace Configuration Variables |
| ELEC_PAGE_FORMAT_DIR | Path to the page formats | WorkSpace Configuration Variables |
| ELEC_TEMPLATES_GRAPHICPLAN_DIR | Path to the graphical plan templates folder | WorkSpace Configuration Variables |
| ELEC_TEMPLATES_PAGE_DIR | Path to the page templates folder | WorkSpace Configuration Variables |
| ELEC_TEMPLATES_REPORT_DIR | Path to the report templates folder | WorkSpace Configuration Variables |
| ELEC_SHOW_PWCHECKIN_DIALOG | Specifies whether the ProjectWise Check In dialog should be displayed when a file is closed or if the file should be automatically checked it in. | |
| ELEC_CERTIFICATE_THUMBPRINT |
Windows Security Thumbprint Certificate. Required in a multi-user environment when using SQL Authentication for the database connection. This variable is in C:\Program Files\Bentley\OpenUtilities Substation CONNECT Edition\Substation\config\appl \Substation.cfg |
N/A |
| _RIBBON_INITIAL_WORKFLOW |
Used to set the initial Ribbon Workflow after a Page is opened. This variable is in C:\Program Files\Bentley\OpenUtilities Substation CONNECT Edition\Substation\config\appl \Substation.cfg |
N/A |
| ELEC_PW_DEFAULTFOLDERNAME |
Name of the OpenUtilities Substation Default project. (Only applies when integrated with ProjectWise) This variable is in C:\Program Files\Bentley\OpenUtilities Substation CONNECT Edition\Substation\config\appl \Substation.cfg |
N/A |
These configuration variables can be set in any configuration file. To understand how these variables are used in the configuration files that are delivered with a default installation of the software, please refer to the Configuration Files topic.
OpenUtilities Substation Managed Configuration Variables
The following configuration variables are exclusively used for a Managed WorkSpace and stored in the following location:
C:\ProgramData\Bentley\OpenUtilities Substation CONNECT Edition\Configuration\WorkSpaces\Substation ANSI-IEEE Example\Standards\Substation\Substation.cfg
# Configuration variables for Managed Configuration, it will download contents automatically.
| Variable Name | Path |
|---|---|
| ELEC_ALL_DATABASE_FILES | = $(AppWorkspaceStandards)Databases/ |
| ELEC_CONFIG_PATH | = $(AppWorkspaceStandards)Config/ |
| ELEC_CONFIG_OPTIONS_PATH | = $(AppWorkspaceStandards)Config/Options/ |
| ELEC_CONFIG_PROFILES_ADDRESS_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Address Files/ |
| ELEC_CONFIG_PROFILES_DEVICE_CROSS_REF_FMT_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Device Cross Reference Formats/ |
| ELEC_CONFIG_PROFILES_DEVICE_ID_FMT_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Device ID Formats/ |
| ELEC_CONFIG_PROFILES_DRAWING_STD_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Drawing Standards/ |
| ELEC_CONFIG_PROFILES_SUBSTATION_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Substation/= |
| ELEC_CONFIG_PROFILES_TEXT_STYLES_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Text Styles/ |
| ELEC_CONFIG_PROFILES_WIRE_LNK_REF_FMT_FILES_PATH | $(AppWorkspaceStandards)Config/Profiles/Wire Link Cross Reference Formats/ |
| ELEC_CONFIG_PROFILES_WIRE_PROP_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Wire Properties/ |
| ELEC_CONFIG_PROFILES_WIRE_TAG_FMT_FILES_PATH | = $(AppWorkspaceStandards)Config/Profiles/Wire Tag Formats/ |
#- Catalogs - Download catalogs automatically in the Managed Workspace.
| Variable Name | Path |
|---|---|
| ELEC_CATALOGS_ALL | $(AppWorkspaceStandards)Catalogs/ABB/;$(AppWorkspaceStandards)Catalogs/CLEVELAND_PRICE/;$(AppWorkspaceStandards)Catalogs/COOPER_POWER_SYSTEMS/;$(AppWorkspaceStandards)Catalogs/HAWKER_SIDDELEY_SWITCH/;$(AppWorkspaceStandards)Catalogs/ROYAL_SWITCHGEAR/;$(AppWorkspaceStandards)Catalogs/SUBSTATION_3D/;$(AppWorkspaceStandards)Catalogs/SUBSTATION_IEEE/;$(AppWorkspaceStandards)Catalogs/SUBSTATION_IEEE_SLD/;$(AppWorkspaceStandards)Catalogs/SEL_RELAYS_(IMPERIAL)/ |
| ELEC_CATALOG_PATH_FAMILIES | $(AppWorkspaceStandards)Catalogs\ABB\Families\;$(AppWorkspaceStandards)Catalogs\CLEVELAND_PRICE\Families\;$(AppWorkspaceStandards)Catalogs\COOPER_POWER_SYSTEMS\Families\;$(AppWorkspaceStandards)Catalogs\HAWKER_SIDDELEY_SWITCH\Families\;$(AppWorkspaceStandards)Catalogs\ROYAL_SWITCHGEAR\Families\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_3D\Families\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617\Families\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617_SLD\Families\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE\Families\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE_SLD\Families\;$(AppWorkspaceStandards)Catalogs\SEL_RELAYS_(IMPERIAL)\Families\ |
| ELEC_CATALOG_PATH_MACROS | $(AppWorkspaceStandards)Catalogs\ABB\Macros\;$(AppWorkspaceStandards)Catalogs\CLEVELAND_PRICE\Macros\;$(AppWorkspaceStandards)Catalogs\COOPER_POWER_SYSTEMS\Macros\;$(AppWorkspaceStandards)Catalogs\HAWKER_SIDDELEY_SWITCH\Macros\;$(AppWorkspaceStandards)Catalogs\ROYAL_SWITCHGEAR\Macros\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_3D\Macros\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617\Macros\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617_SLD\Macros\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE\Macros\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE_SLD\Macros\;$(AppWorkspaceStandards)Catalogs\SEL_RELAYS_(IMPERIAL)\Macros\ |
| ELEC_CATALOG_PATH_SYMBOLS | $(AppWorkspaceStandards)Catalogs\ABB\Symbols\;$(AppWorkspaceStandards)Catalogs\CLEVELAND_PRICE\Symbols\;$(AppWorkspaceStandards)Catalogs\COOPER_POWER_SYSTEMS\Symbols\;$(AppWorkspaceStandards)Catalogs\HAWKER_SIDDELEY_SWITCH\Symbols\;$(AppWorkspaceStandards)Catalogs\ROYAL_SWITCHGEAR\Symbols\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_3D\Symbols\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617\Symbols\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617_SLD\Symbols\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE\Symbols\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE_SLD\Symbols\;$(AppWorkspaceStandards)Catalogs\SEL_RELAYS_(IMPERIAL)\Symbols\ |
| ELEC_CATALOG_PATH_TITLEBLOCKS | $(AppWorkspaceStandards)Catalogs\ABB\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\CLEVELAND_PRICE\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\COOPER_POWER_SYSTEMS\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\HAWKER_SIDDELEY_SWITCH\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\ROYAL_SWITCHGEAR\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_3D\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEC60617_SLD\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SUBSTATION_IEEE_SLD\TitleBlocks\;$(AppWorkspaceStandards)Catalogs\SEL_RELAYS_(IMPERIAL)\TitleBlocks\ |